DMSendDependentNotification

DMSendDependentNotification
Header:	Displays.h		Carbon status:	Supported

Notifies dependent displays of changes in depth mode or configuration.

OSErr DMSendDependentNotification (
    ResType notifyType, 
    ResType notifyClass, 
    AVIDType displayID, 
    ComponentInstance notifyComponent
);

notifyType: The resource type that identifies the engine that made the change. Examples might be component engines that control brightness, contrast, or screen size. You may pass zero in this parameter. See DependentNotifyRec (page 4) for more information.
notifyClass: The resource type that identifies the class of change the user or engine has made, such as color depth, pixel size, or screen size. See DependentNotifyRec (page 4) for more information.
displayID: The ID number of the dependent display which you want to notify of Display Manager events. On return, the Display Manager sets the notifyPortID constant of the DependentNotifyRec (page 4) structure. See “Display/Device ID Constantsî for more information.
notifyComponent: A value that notifies the display component what engine, if any, caused a change in a dependent display. You may pass 0 in this parameter.

function result: A result code.

DISCUSSION

The Display Manager uses the DMSendDependentNotification function to send notifications to registered Display Notice event-handling functions. This function uses all its parameters to supply values for the DependentNotifyRec structure which is sent out to registrants. Generally, your application does not need to use this function.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when DisplayLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by DisplayLib 2.0 and later.